Admin Console System Properties

Properties

 Mandatory Data Type Format Size Default

Allowed Values

Usage detail

application.defaultLocale

 YES Standard List       As per  IETF BCP 47, supported by JAVA

Specifies the language in which the application's pages should be displayed.

Example:

ja_JP: login screen will appear in Japanese.

en-US: login screen will appear in English.

Note: Once the user logs in, the language is determined by that user's locale.
application.mode YES Alphabetic Fixed List <=11  

Value:

DEVELOPMENT, PRODUCTION

  • In Development mode, configuration changes are allowed. Configuration data is not cached.

  • In Production mode, configuration changes are allowed in a new release. JVM should be restarted when configuration changes are made. Configuration data is cached.

  • Should be set to PRODUCTION in production environment.
application.jmx.reconnect.period NO Integer   <=6 3000

 

 The interval of time to check the JMX connection. Calculated in milliseconds.
application.jmx.initial.delay NO Integer   <=6 6000

 

 The interval of time to hold checking of JMX connection after server start. Calculated in milliseconds.
transaction.manager YES Alphabetic Fixed 3  

Value:

jpa

 Datasource transaction manager
jpa.showSql   Boolean   <=5 False

Value:

  • True

  • False

Shows information in the application's log/console for all SQLs executed using JPA.

Should be used only in Non-Production environment.
jpa.databasePlatform YES AlphaNumeric Fixed List <=100  

Value: org.eclipse.persistence.platform.database.SQLServerPlatform org.eclipse.persistence.platform.database.OraclePlatform org.eclipse.persistence.platform.database.DB2Platform

Determines which JPA DatabasePlatform to be used with EclipseLink.
application.databaseType YES Fixed List   <=10  

SqlServer, Oracle, DB2

The system-wide default database type. Used for multiple query support functionality and JDBC interaction.
application.buildversion   NUMBER nn.nn.nn.nn 11  

n - Digit from 0 to 9 inclusive

Defines the build version of the application.
application.default.buildversion   AlphaNumeric         Should be used only when theapplication.buildversionproperty is set and begins with ${Defines the build version of the application on the login screen.
environment.name   AlphaNumeric         Defines the Environment of the application on the login screen
database.nlscomp   Alphabetic Fixed List <=15 LINGUISTIC

Value:

LINGUISTIC, BINARY, ANSI

Refer to https://docs.oracle.com for the version of Oracle used for a current listing of values you can specify for this parameter.

The value is applied when the system uses the Oracle database. It provides the NLS_COMP setting that the system should use in the database session in order to perform Case/Accent insensitive search.

Default value: LINGUISTIC.

The DBA should setup appropriate indexes for this property and suggest the setting value to be used based on the client's installation language preference.
database.nlssort   Alphabetic Fixed List <=25 BINARY_CI Refer to Database Globalization Support Guide and other related documents at https://docs.oracle.com/ for a current listing of values you can specify for this parameter

It is applicable only if Oracle database is used.

It provides the NLS_SORT setting that the system should use in the database session in order to perform Case/Accent insensitive search.

The DBA should setup appropriate indexes for these properties and suggest the setting value to be used based on the client's installation language preference.

The default setting for OIPA is a sort that is accent-sensitive and case-insensitive.
taskExecutor.threadPoolSize YES Whole Number nnn <=3     Defines thethreadPoolSizeallocated for the java task executor to handle the notifications.
oipa.url YES AlphaNumeric        

OIPA application URL to interact with OIPA services.

Example: http://localhost:8080/PASJava/
application.warningcount   Whole Number nnn   1000  

This property is used in Export functionality for REST and SOAP audit logs.

The max count of rows to display warning message.

If the value of the export row count exceeds the default value then the system present a warning message on the banner.
service.url Yes AlphaNumeric        

This property is used to connect to ServiceLayer from Admin Console.

Example:

http://localhost:9093/PASService/
cycle.url Yes AlphaNumeric        

This property is used to connect to Cycle server from Admin Console.

Example:

http://localhost:9091/CycleService/
cycleClient.refreshTime Yes Positive Integer     3 Value: Integer (Value representing seconds)

This property is used to calculate the frequency of time at which cycle client results table refreshes from CycleClient UI - (seconds).
service.trustStore            

This property is used to connect to Service Layer server from Admin Console with https connection.

Note: Due to security reasons service.trustStorePassword property has been moved from ac.properties file to environment variables

            

This property is used to connect to the Service Layer server from Admin Console with https connection.
cycle.trustStore             This property is used to connect to the Cycle server from Admin Console with https connection.
application.Access-Control-Allow-Origin No AlphaNumeric Fixed List / * <=255 None Value: <url>,*,

To enable the web server to make cross domain requests. <url> => list of allowed domains, which are making service calls. * => This allows access to all domains, but using this wildcard character is considered overly permissive policy.
application.X-Frame-Options    No AlphaNumeric Fixed List / Free text Parameter <=255 None

Value:

DENY, SAMEORIGIN, ALLOW-FROM <url>

  • Supports against CSRF attacks. Applies only to IE8 and above.

    If property is not specified, no system protection against CSRF is offered.

  • If DENY is set, any application page is not allowed to be framed.

  • If SAMEORIGIN is set, application is allowed to be framed in any page coming from the same root url. (SAMEORIGIN means the same root URL).

  • If ALLOW-FROM <url> is set, application is allowed to be framed from any page coming from the root URL specified in the property.
cors.allowGenericHttpRequests Yes Boolean     true true or false If property value is to true generic HTTP requests will be allowed to pass through the filter else only valid CORS requests will be allowed.
cors.allowOrigin Yes Alphanumeric Fixed List / *    * (asterisk) * or Origin list separated with space Add all the URLs of OIPA, SL, Cycle as they interact with AdminConsole
cors.allowSubdomains Yes Boolean     false true or false If this property value is set to true, allow requests from any origin which is a subdomain origin of the allowed origins ( cors.allowOrigin ).
cors.supportedMethods Yes Alphanumeric Fixed List, Comma separated   GET, POST, HEAD, OPTIONS, PUT, DELETE GET, POST, HEAD, OPTIONS, PUT, DELETE HTPP supportedMethods This property defines through Access-Control-Allow-Methods header, list of HTTP methods allowed for the request. for Example, if GET is added in supportedMethods then only GET cross-origin requests is allowed.
cors.supportedHeaders Yes Alphanumeric     * (asterisk)   This is any custom header set by the application through XMLHttpRequest.setRequestHeader() for example Content-Type, X-Requested-With
cors.exposedHeaders No Alphanumeric     empty list   This is list of headers which are safe to be exposed in the response and this information is sent through Access-Control-Expose-Headers for example , Custom-Exposed-Header-1 , Custom-Exposed-Header-2
cors.supportsCredentials Yes Boolean     true true or false This property value identifies in constructing Access-Control-Allow-Credentials header. 
cors.maxAge Yes Integer     -1   This property indicates how long the preflight request can be cached by the web browser; this value is mentioned in seconds. for example, if the value is mentioned as 3600 means browsers should cache preflight request for 1 hour.
datasource.type YES Alphabetic Fixed 4 none Value: jndi

The data source type.

jndi relies on jndi names ADMINSERVERDS, ADMINSERVERRESOURCEDS ADMINSERVERSEARCHDS and ADMINSERVERREADONLYDS in the application server for a datasource connection.

  • ADMINSERVERDS: Used for all application SQLs, Stored Procedures, Configuration SQLs and JPA

  • ADMINSERVERRESOURCEDS: Used for loading Translations

  • ADMINSERVERSEARCHDS: Used for Search Queries with NLS_SORT and NLS_COMP settings.

    • CaseInsensitiveSearches.

  • ADMINSERVERREADONLYDS: Data Retriever (Data Objects) for JDBC Finder Queries (Non-JPA)

    • CipherKeys

    • MapGroup Retriever